home *** CD-ROM | disk | FTP | other *** search
/ PsL Monthly 1993 December / PSL Monthly Shareware CD-ROM (December 1993).iso / prgmming / dos / pascal / gnoom.com / GNOOM.DOC < prev    next >
Encoding:
Text File  |  1990-12-20  |  8.9 KB  |  224 lines
  1.  
  2.                          G N O O M
  3.                       UFP image editor
  4.                       ----------------
  5.  
  6.            Written with Borland's Turbo Pascal 5.5
  7.  
  8.      This program is Public Domain. Feel free to use and
  9.      distribute it as long as all the files listed below
  10.      are distributed together. You can also freely use
  11.      images created with GNOOM in all your programs. No
  12.      additional payment required.
  13.  
  14.      OVERVIEW
  15.  
  16.      This program will allow you to edit up to 10 16-color
  17.      images on one screen. Images can have size from 2 x 2
  18.      to 64 x 64 pixels each. You can also animate your
  19.      images and save them on disk. Images created with
  20.      GNOOM can be easily loaded from your program in Turbo
  21.      Pascal 5.5 (Probably, they will work from TP4.0 and
  22.      TP5.0 as well but I can not guarantee it).
  23.  
  24.      GNOOM FILES
  25.  
  26.      1. GNOOM.EXE           The editor itself
  27.      2. GNOOM.DOC           This documentation
  28.      3. GNOOM.TPU           TP unit allowing you to use GNOOM
  29.                             images in your programs
  30.      4. GNLOADER.PAS        Pascal source code for GNOOM.TPU
  31.      5. GNDEMO.PAS          Small Pascal demonstration program
  32.      6. MONSTER.GNM         Images required for GNDEMO.PAS
  33.      7. PIXEL.PAS           Demo program, showing how to make
  34.                             GNOOM images move OVER background
  35.                             picture.
  36.      8. GIRL.GNM            Images required for PIXEL.PAS
  37.  
  38.      REQUIREMENTS
  39.      
  40.      1. EGA (640x200, 16 colors)
  41.      2. AT-286 (or better)     may work on slower machines too, 
  42.                                but, of course, slower.
  43.      3. DOS 3.3 
  44.  
  45.      HOW TO USE "GNOOM"
  46.  
  47.      1. Firstly set the size of the images. Use up-down arrows
  48.         to change the number of rows (2..64) and left-right arrows
  49.         to change the number of columns (2..64). Press ENTER when
  50.         finished.
  51.      2. Main menu
  52.         Use TAB key to select options in the main menu (menu is
  53.         in the right bottom corner of the screen). Press ENTER to
  54.         execute selected option.
  55.         
  56.         SAVE    - saves images on disk in the current directory.
  57.                 Select images to save by pressing F1-F10. Press
  58.                 'S' when finished. Then type the file name (up to
  59.                 8 symbols) and press ENTER.
  60.         LOAD    - loads images from disk. Type the file name (up to
  61.                 8 symbols) and press ENTER. (NOTE: you can't change
  62.                 directory!)
  63.         NEW     - Erases all 10 images and lets you to enter new
  64.                 size of the images.
  65.         ANIMATE - Animates your images. Use left-right arrows and
  66.                 SPACE BAR to select images to animate. Up to 100
  67.                 frames of animation are possible. Press ENTER to
  68.                 begin animation. During the animation use '[' and
  69.                 ']' keys to change speed, ENTER to stop.
  70.         QUIT    - Exit to DOS
  71.  
  72.      3. Editing
  73.         While editing your images use the following keys:
  74.         
  75.         ARROWS    - to move cursor
  76.         SPACE BAR - to draw a dot with current color
  77.         '+' & '-' - to select color
  78.         '[' & ']' - to invert image
  79.         'C'       - to clear current image
  80.            'W'
  81.         'A' + 'S' - to move entire image up, down left or right
  82.            'Z'
  83.         F1-F10    - to select image for editing
  84.                     +----+----+----+----+
  85.                     | F1 | F2 | F3 | F4 |
  86.                     +----+----+----+----+
  87.                     | F5 | F6 | F7 | F8 |
  88.                     +----+----+----+----+
  89.                     | F9 |F10 |ANIM|MENU|
  90.                     +----+----+----+----+
  91.         CNRL F1 - CNRL F10 - to copy one image to another
  92.                     For example, to copy image #5 to image #7
  93.                     press F7 and then CNRL F5.
  94.  
  95.      HOW TO LOAD GNOOM IMAGES FROM TURBO PASCAL
  96.  
  97.      1. Add line "uses Gnoom;" to your Pascal program
  98.         (GNOOM.TPU should be in the current directory!)
  99.         GNOOM.TPU contains only one procedure - GnoomImage.
  100.         See GNLOADER.PAS for details.
  101.      2. Define variable of 'GnType' type;
  102.         for example,
  103.          
  104.         var Im : GnType;
  105.  
  106.         (Gntype = array [ 1..10 ] of pointer)
  107.      3. Use GnoomImage procedure to load images from disk.
  108.  
  109.         Format:
  110.  
  111.         GnoomImage( filename : string ;
  112.                     var GnIm : GnType ;
  113.                     var GnSprNum : byte );
  114.  
  115.         filename : name of the Gnoom file (up to 8 symbols) without
  116.                    '.GNM' extension.
  117.         GnIm     : variable of 'GnType' type defined before.
  118.         GnSprNum : number of images found in the file.
  119.  
  120.         Example:
  121.  
  122.         GnoomImage( 'GIRL', Im, N );
  123.  
  124.         (This command will open file 'GIRL.GNM', put information
  125.         about images into variable Im and put the number of loaded
  126.         images into variable N)
  127.      4. Then you can use PutImage command in a usual way, for
  128.         example:
  129.  
  130.         PutImage(100,100,Im[2]^,NormalPut);     or
  131.         PutImage(200,120,Im[3]^,XORPut);
  132.  
  133.         NOTE: Though GNOOM allows to edit images only in
  134.               low resolution (640x200) you can load images and
  135.               and use them in high resolution (640x350) as well.
  136.  
  137.         ----- SEE <GNDEMO.PAS> FILE FOR MORE DETAILS -----
  138.  
  139.      5. Unfortunately, Turbo Pascal 5.5 does not have commands to
  140.         make images move "over" background picture. XORPut mode
  141.         makes something like this but at the same time it changes
  142.         colors of the image. PIXEL.PAS file shows one (though
  143.         I am sure, not the best) way to solve this problem. This
  144.         example simply draws image pixel by pixel but makes it
  145.         quickly enough.
  146.  
  147.         NOTE: GNDEMO.PAS and PIXEL.PAS can work only if the current
  148.               directory contains GRAPH.TPU and EGAVGA.BGI
  149.  
  150.      WHAT IS NEXT?
  151.  
  152.      It is obvious that there are many things in GNOOM that are
  153.      to be improved:
  154.      1. Saved images use too much space on disk
  155.      2. Images load too slowly
  156.      3. Images can not have different sizes
  157.      4. Only 10 images can be edited at the same time
  158.      5. GNOOM does not support high resolution EGA
  159.      6. GNOOM does not have DIR option
  160.         and so on...
  161.      In my opinion, correcting this version of GNOOM will not
  162.      solve these problems. But maybe (I have not decided yet)
  163.      I shall write GNOOM II, an absolutely different program,
  164.      where I shall correct all these bugs. But in spite of it
  165.      I think some people will find this first version of GNOOM
  166.      interesting and useful. (Especially as it is FREE!)
  167.  
  168.      Nikolay Soumarokov
  169.      Erzherzog Karl Str. 182
  170.      1220 Vienna, Austria
  171.  
  172.  
  173.  
  174.        
  175.         
  176.            
  177.  
  178.          ----------------end-of-author's-documentation---------------
  179.  
  180.                          Software Library Information:
  181.  
  182.                     This disk copy provided as a service of
  183.  
  184.                            Public (software) Library
  185.  
  186.          We are not the authors of this program, nor are we associated
  187.          with the author in any way other than as a distributor of the
  188.          program in accordance with the author's terms of distribution.
  189.  
  190.          Please direct shareware payments and specific questions about
  191.          this program to the author of the program, whose name appears
  192.          elsewhere in  this documentation. If you have trouble getting
  193.          in touch with the author,  we will do whatever we can to help
  194.          you with your questions. All programs have been tested and do
  195.          run.  To report problems,  please use the form that is in the
  196.          file PROBLEM.DOC on many of our disks or in other written for-
  197.          mat with screen printouts, if possible.  PsL cannot debug pro-
  198.          programs over the telephone, though we can answer questions.
  199.  
  200.          Disks in the PsL are updated  monthly,  so if you did not get
  201.          this disk directly from the PsL, you should be aware that the
  202.          files in this set may no longer be the current versions. Also,
  203.          if you got this disk from another vendor and are having prob-
  204.          lems,  be aware that  some files may have become corrupted or
  205.          lost by that vendor. Get a current, working disk from PsL.
  206.  
  207.          For a copy of the latest monthly software library newsletter
  208.          and a list of the 2,000+ disks in the library, call or write
  209.  
  210.                            Public (software) Library
  211.                                P.O.Box 35705 - F
  212.                             Houston, TX 77235-5705
  213.  
  214.                                 1-800-2424-PSL
  215.                              MC/Visa/AmEx/Discover
  216.  
  217.                           Outside of U.S. or in Texas
  218.                           or for general information,
  219.                               Call 1-713-524-6394
  220.  
  221.                           PsL also has an outstanding
  222.                           catalog for the Macintosh.
  223.  
  224.